home *** CD-ROM | disk | FTP | other *** search
/ Aminet 51 / Aminet 51 (2002)(GTI - Schatztruhe)[!][Oct 2002].iso / Aminet / util / conv / sapmaker.lha / SAP Maker / sapmaker.txt < prev    next >
Encoding:
Text File  |  2002-08-13  |  5.9 KB  |  162 lines
  1. SAP MAKER
  2. CMC,CMR,MPT,MD1,MD2,TMC,TM8,AMS -> SAP file converter
  3. Public Domain
  4. =================================================
  5.  
  6. Introduction
  7. ------------
  8. This simple utility was made for making SAP files from common music formats
  9. easier. With it you only have to specify names of files to convert
  10. and SAP MAKER will do the rest. It automatically recognizes type of file
  11. (it's too much said, it only checks file name extension :) ) and creates
  12. SAP file containing the music.
  13.  
  14. SAP MAKER is distributed with full C source as public domain, so that
  15. everyone is allowed to make changes in it and distribute changed version.
  16. I only ask for writing down all changes made and adding name or nick
  17. to credits, because I don't want to be blamed for others' mistakes nor
  18. be glorified for things I haven't done.
  19.  
  20. Source is portable and is able to be compiled on any system (at least I hope
  21. so). If you have can make some changes to make it even more portable,
  22. please feel free to distribute corrected version.
  23.  
  24. I also include the executable for PC/WIN compiled with DJGPP gcc 3.0.2
  25. with -s -O2 options. If you can produce smaller executable, please distribute
  26. it. Note long file names have to be supported.
  27.  
  28. The *.plr files are simply Jaskier's players compiled at $0500 and $f500,
  29. Except for ams_0500.plr, which is written by me, basing on code in
  30. "Composer's Jukebox II" (an old AMS player).
  31.  
  32. About SAP files
  33. ---------------
  34. SAP stands for Slight Atari Player. File in .SAP format contains all data
  35. necessary for playing music emulating POKEY sound chip and 6502 processor,
  36. and some information about music. SAP MAKER is able to create the binary part,
  37. but of course it can't guess the name or the author.
  38.  
  39. Usage
  40. -----
  41. First, collect all files you want to convert in a single directory.
  42. Give them proper file name extensions:
  43.  
  44. CMC     - for standard Chaos Music Composer files
  45. CMR     - for Chaos Music Composer files with changed bass table
  46.           (created with "CMC Rzog")
  47. MPT     - for Music ProTracker 2.4 files
  48.           This extension is for tunes without samples
  49. MD1/D15 - for Music ProTracker 2.4 tunes with single 15 kHz digi
  50.           Such music consists of two files: MPT music and samples data.
  51.           These files should have same name and MD1 and D15 extensions
  52.           respectively
  53. MD1/D8  - for Music ProTracker 2.4 tunes with single 7.5 kHz digi
  54.           Same as above except for lower quality of samples
  55. MD2/D8  - for Music ProTracker 2.4 tunes with two digi channels
  56.           Music in MD2 file, samples in D8.
  57. TMC     - for Theta Music Composer files
  58.           This extension is for tunes which can be played with single POKEY
  59. TM8     - for Theta Music Composer STEREO tunes
  60. AMS     - for Advanced Music System (?) files
  61.           Support for this format is experimental, because I have no
  62.           documentation for it.
  63.  
  64. The directory should also contain SAP MAKER executable and all
  65. necessary *.plr files.
  66.  
  67. You should create a file containing information for all tunes. This file
  68. must contain at least file names. The easiest way to create it on a PC
  69. is to use:
  70.  
  71. dir /b/on >sapinfo.txt
  72.  
  73. This command creates sapinfo.txt file containing alphabetical list of all
  74. files in current directory. You can edit this file with any text editor.
  75. Leave only lines containing names of files you want to convert.
  76. You have to delete lines with sapinfo.txt, sapmaker.txt and *.plr files.
  77. Note when converting MD1/D15 you give only MD1 file name.
  78.  
  79. Then you are already able to convert. Simply run SAP MAKER with name of info
  80. file:
  81. sapmaker sapinfo.txt
  82.  
  83. If everything was ok, SAP MAKER doesn't display any message. Simply you have
  84. all your files successfully converted and you may replay them.
  85.  
  86. That were the basics. SAP MAKER has some more features. To use them you edit
  87. the info file. Each line has following syntax:
  88. source_file sap_file.sap SONGS DEFSONG "Author" "Name" "Date"
  89. All parameters excluding source_file are optional. Note you have to add .sap
  90. extension to SAP file name and you have to enclose song informations
  91. in quotation marks. You may use both spaces and tabs to separate fields.
  92. Here is an example:
  93. DRUCH.MPT Drunk_Chessboard.sap 1 0 "Lukasz Sychowicz (X-Ray)" "Drunk Chessboard" "1996"
  94.  
  95. You may skip SONGS if there's only one song. In fact SAP MAKER supports
  96. subsongs only for CMC files. DEFSONG is the number of subsong which will be
  97. replayed by default when the .SAP file is loaded. Note subsongs are numbered
  98. starting from 0.
  99.  
  100. You can insert comment line by putting ';' as first character in line.
  101. Blank lines are also allowed.
  102.  
  103. If you don't know the author, but only the name, please use "<?>" in meaning
  104. "unknown". Please comply ASMA naming conventions:
  105. - only 'A..Z', 'a..z', '0..9' and '_' characters are allowed in file names
  106. - a file name can be up to 26 characters long (with '.sap' extension file name
  107.   can be up to 30 characters long)
  108.  
  109. The ASMA is a collection of .SAP files. Please help to make this collection
  110. as big as its C-64 equivalent. For details, visit
  111. http://asma.dspaudio.cz
  112.  
  113. Credits
  114. -------
  115. Idea - Pigula/Shpoon, Solo/NG
  116. Design, code, this text - Fox/Taquart <fox@scene.pl>
  117. All players - Jaskier/Taquart
  118.  
  119. Changes
  120. -------
  121. Please list here all changes you make in SAP MAKER:
  122.  
  123. * * *
  124.  
  125. 12th Dec 2000.
  126. Ideas - Dracon/Taquart
  127. Code - Fox/Taquart
  128. Changes:
  129. - Support for MPT modules with two digi channels.
  130.   Use .MD2 extension for modules and .D8 for samples.
  131. - Support for "CMC Rzog" modules with changed bass table.
  132.   Just rename files to *.CMR.
  133. - Samples relocated automatically if conficting with MD1/MD2.
  134. - Changed coding style. Many spaces added.
  135.  
  136. * * *
  137.  
  138. 9th August 2001.
  139. Ideas - Pigula/Shpoon
  140. Code - Fox/Taquart
  141. Changes:
  142. - Support for MD1 modules with D8 samples.
  143.   If no .D15 samples are found for a MD1 module, .D8 samples are read.
  144.  
  145. * * *
  146.  
  147. 7th February 2002.
  148. Ideas - Fox/Taquart
  149. Code - Fox/Taquart
  150. Changes:
  151. - Support for AMS modules.
  152. - Display info file name if the file can not be opened.
  153.  
  154. * * *
  155.  
  156. 13th August 2002.
  157. Amiga port - Voy/SSG/Dial
  158. Changes:
  159. - Title strings added.
  160.  
  161. * * *
  162.